OpenEdge Application Server:<br />Administration Configuring BrokerConnect

BrokerConnect is a Unified Broker product and part of the Progress Explorer framework. On the Windows platform, you can use the Progress Explorer to start, stop, get status, add, delete, and edit properties of BrokerConnect.

Make sure that the AdminServer is running on the host where you want to configure the BrokerConnect instance.

Open the Progress Explorer from the OpenEdge program group or in the Microsoft Management Console (MMC).

Connect to the AdminServer on your BrokerConnect host.

Do one of the following:

To define a new adapter instance, select the SonicMQ Adapter folder in the Progress Explorer’s tree view and open the New dialog box. Enter a unique name for the adapter instance. Choose OK. The Preferences dialog box appears. Set any global preferences that you require (see the online help), and choose OK. The BrokerConnect instance property editor appears.

To modify an existing BrokerConnect configuration, expand the SonicMQ Adapter folder in the tree view, select the adapter instance you want to modify, and open the property editor.

The property editor shows a tree view of property categories on the left and the properties for the selected category on the right.

Select a property category and set the properties as required. You can accept the default values, if they are appropriate for your application.

For information on setting the CLASSPATH, see the "Setting the CLASSPATH" section.

Expanding the Broker category shows the following property subcategories:

General — Specify a working directory and the TCP/IP port number where BrokerConnect listens for requests. Check the Auto start box if you want the adapter to start whenever you start the AdminServer.

Owner Information — You can optionally provide Username and Password information for the user who owns the BrokerConnect instance.

Controlling NameServer Information — If you plan to use a NameServer to control BrokerConnect access, check the Register with NameServer box and select a controlling NameServer from the drop-down list. Select one of the three Registration Mode options to specify how you want the NameServer to provide the host address of BrokerConnect for client connections.

Note: If BrokerConnect is not registered with a controlling NameServer, clients connect directly to the adapter by specifying its TCP/IP host and port with the -DirectConnect parameter.

AppService Name List — Enter the names of the application services that the BrokerConnect instance is to register with the controlling NameServer, if any. Clients connecting to the adapter must specify one of these service names.

Logging Setting — Specify a pathname for the broker log file, the level of logging detail, and whether the logging for a session appends to or overwrites the previous broker log file.

Advanced Features — Specify the maximum number of client connections (Maximum client instances) that the BrokerConnect can support at one time. Also specify an interval in seconds (Registration Retry) to set the frequency with which the adapter sends a “keep-alive” message to tell the NameServer that it is active.

Expanding the Server category shows the following property subcategories:

General — Specify any startup parameters for BrokerConnect.

Logging Setting — Specify a pathname for the server log file, the level of logging detail, and whether the logging for a session appends to or overwrites the previous broker log file.

Pool Range — These settings determine the number of threads that the BrokerConnect agent can start up and maintain. One thread is required for each active client application.

The options in the SSL category options define the security settings for an SSL-enabled BrokerConnect instance. Note that a BrokerConnect enabled for SSL operation does not accept non-SSL client connections. For more information on SSL operations, see OpenEdge Getting Started: Core Business Services . Expanding this category shows the following property subcategories:

General — If you check the Enable SSL Client Connections box, select the alias for the private key/digital certificate entry (in the OpenEdge keystore) that you want to secure connections for this adapter instance. Also enter and confirm the password for this private key and digital certificate. You need not enter a password if you choose to use the default_server certificate and its default password.

Advanced Features — By default, caching is enabled for the SSL client session, and you can enter a time-out value that specifies the length of time (in seconds) that a disconnected session is held in the cache. During this specified interval, a connected client can resume its session. To disable session caching, check the box.

Select the Environment Variables if you want to specify environment variables for BrokerConnect execution. It allows you to enter name-value pairs for environment variable settings. Any values you set here override prior values set for the same environment variables in the operating system.

Click OK to save the configuration.